home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / comm1 / dannylog.lha / Documentation.txt < prev    next >
Text File  |  1996-04-22  |  4KB  |  110 lines
  1.    Welcome to Dannylog. A logfile parser written especially for AWS, the
  2. Amiga Web Server.
  3.  
  4.    This software is freeware, though I would appreciate an email, postcard,
  5. or what-have-you. To get in contact with me;
  6.  
  7. Email: dannyman@uiuc.edu
  8. WWW: http://www.uiuc.edu/ph/www/djhoward
  9. Post: Daniel Howard
  10.      7310 N Claremont
  11.   Chicago, IL 60645-1808
  12.       United States
  13.  
  14. *** Disclaimer ***
  15.  
  16.    Dannylog is a work-in-progress. Additional information is available at
  17. http://www.uiuc.edu/ph/www/djhoward/dev/
  18.  
  19.    There are no guarantees implied in use of this product. The authoer,
  20. however, trusts his logfiles and historical recording to it, and has yet to
  21. see Dannylog do something really bad like frying a harddrive or exploding a
  22. computer. :)
  23.  
  24. *** Theory of Operation ***
  25.  
  26.    There are three executables at the moment.
  27.  
  28. Dannylog - Main program executable. Will read in from current directory
  29. stats/data.raw files, then it will parse an access log, and rewrite
  30. stats/data.raw files with data from the read logfile in them. After this,
  31. the access log can be deleted. As of version alpha5, Dannylog will not log
  32. any entry that returns a status other than 200, rather, it will print it to
  33. standard output, a second optional argument can be taken to indicate where
  34. this output should be written to, however.
  35.  
  36. t10 - Helper application that can analyse a stats/data.raw file
  37. and extract the top 10 or other values from them, matched against an AmigaDOS
  38. wildcard pattern. t10 operates on the following files that Dannylog will
  39. place in stats/
  40.  
  41. requested.raw
  42. refereres.raw
  43. hosts.raw
  44.  
  45. tTOD - Outputs total satisfied requests that Dannylog has found in it's
  46. logfiles. In the future, a limitation will be added to Dannylog to reduce
  47. hit counts to a maximum possible of 4,000,000 in any given hour period, for
  48. reasons of stability. Likely all numbers will be halved when any hour
  49. exceeds 4,000,000 satisfied requests. This is not likely to happen to any
  50. Dannylog servers in the near future though, the author estimates. :)
  51.  
  52. *** Usage ***
  53.  
  54. --Dannylog--
  55.  
  56.    From a command-line, type;
  57.  
  58. Dannylog <input-file> [output-file]
  59.  
  60.    whereas <logfile> is an access log generated by AWS, and [output-file] is
  61. where you would like to send the Dannylog error reports.
  62.  
  63.    For example;
  64.  
  65. Dannylog aws:access.log aws:error.log
  66.  
  67. --t10--
  68.  
  69. TEMPLATE: FILE/A,NUM/K/N,Pat=PATTERN/K,HTML/S
  70.  
  71.    Whereas <statsfile> is a file generated by Dannylog of the form
  72. stats/data.raw and [Pattern] is an optional AmigaDOS wildcard pattern that
  73. is matched case-insensitively against the data in question. The pattern
  74. defaults to #? if none is given, thus no matching is done and the absolute
  75. top ten of a given field are returned. NUM is another optional paramater if
  76. you want something other than the top ten returned. Another option switch
  77. has been added with alpha5. If HTML is specified on command-line, Dannylog
  78. will write output as an HTML table.
  79.  
  80.    Example;
  81.  
  82. t10 stats/hosts.raw num 5 pattern #?uiuc#?
  83.  
  84.    This will tell you the top five requesting hosts from the University of
  85. Illinois ...
  86.  
  87. tTOD
  88.  
  89. TEMPLATE: FILE/K,HTML/S
  90.  
  91.    Reads stats/hours.raw and outputs information on time-of-day business of
  92. the server. Includes an AmigaDOS switch for HTML, and an optional file label
  93. just in case your relevant datafile is something other than stats/hours.raw.
  94.  
  95. --s/dostats--
  96.  
  97.    The file s/dostats is included with this archive. It is a script I use on
  98. my system as AWS:s/dostats to do stuff. Take a look at it to get a good idea
  99. of how things work. To see what it generates, refer to
  100. http://arh0268.urh.uiuc.edu/stats/access.html
  101.  
  102. *** Important Note ***
  103.  
  104.    t10 REQUIRES at least 8k of stack! If you do not set this, you risk
  105. crashing, BIG TIME! Dannyman reccomends saying "stack 10000" before running
  106. t10!
  107.  
  108.    Dannylog expects that in the directory from which you run it that there
  109. be a directory called stats this is where Dannylog sends most output.
  110.